<!DOCTYPE html>
<html lang="en-US">
    <head>
        <title>Data::Validate::IP - IPv4 and IPv6 validation methods - metacpan.org</title>
        <link rel="preload" as="fetch" href="https://metacpan.org/account/login_status" crossorigin="anonymous" />
        <link href="https://metacpan.org/_assets/b8ccceeed47a0652049703d99326a9cea4933443.css" rel="stylesheet" type="text/css">
        <script src="https://metacpan.org/_assets/6bfedafe2d7caa915b7d84f61b45936818e3242e.js" type="text/javascript" defer></script>
        <link rel="alternate" type="application/rss+xml" title="Recent CPAN Uploads of Data-Validate-IP - MetaCPAN" href="https://metacpan.org/dist/Data-Validate-IP/releases.rss" />
        <link rel="canonical" href="./Data::Validate::IP.html" />
        <meta name="description" content="IPv4 and IPv6 validation methods" />
        <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=5">
        <link rel="shortcut icon" href="https://metacpan.org/static/icons/favicon.ico">
        <link rel="apple-touch-icon" sizes="152x152" href="https://metacpan.org/static/icons/apple-touch-icon.png">
        <link rel="search" href="https://metacpan.org/static/opensearch.xml" type="application/opensearchdescription+xml" title="MetaCPAN">
        <script>
          (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
          (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
          m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
          })(window,document,'script','//www.google-analytics.com/analytics.js','ga');

          (function(skey, ga_id){
            ga('create', ga_id, {
              siteSpeedSampleRate : 100,
              storage             : 'none',
              clientId            : localStorage.getItem(skey)
            });
            ga(function(tracker) {
              localStorage.setItem(skey, tracker.get('clientId'));
            });
            ga('send', 'pageview');
          })('ga:clientId', 'UA-27829474-1');
        </script>
<meta name="twitter:card"        content="summary" />
<meta name="twitter:url"         content="https://metacpan.org/pod/Data::Validate::IP" />
<meta name="twitter:title"       content="Data::Validate::IP" />
<meta name="twitter:description" content="IPv4 and IPv6 validation methods" />
<meta name="twitter:site"        content="metacpan" />
    </head>
    <body>
        <nav class="navbar navbar-default" role="navigation">
            <div class="header-logo-large hidden-xs">
              <a href="https://metacpan.org/" tabindex="0">
                <svg class="logo" aria-label="MetaCPAN">
                  <use class="logo" href="/static/images/metacpan-logo.svg#logo" />
                </svg>
              </a>
            </div>
            <div class="header-logo-icon visible-xs">
              <a href="https://metacpan.org/">
                <svg class="logo" aria-label="MetaCPAN">
                  <use class="logo" href="/static/images/metacpan-logo.svg#dots" />
                </svg>
              </a>
            </div>
            <ul class="nav navbar-nav menu-items hidden-xs hidden-sm">
              <li><a href="https://metacpan.org/about">About</a></li>
              <li><a href="https://metacpan.org/about/sponsors">Sponsor</a></li>
              <li><a href="https://grep.metacpan.org/">grep::cpan</a></li>
              <li><a href="https://metacpan.org/recent">Recent</a></li>
              <li><a href="https://metacpan.org/about/faq">FAQ</a></li>
              <li><a href="https://metacpan.org/tools">Tools</a></li>
              <li><a href="https://fastapi.metacpan.org/">API</a></li>
            </ul>
            <ul class="nav navbar-nav navbar-right">
                <button type="button" class="searchbar-btn visible-xs visible-sm">
                    <i class="fa fa-search button-fa-icon"></i>
                </button>
                <form action="https://metacpan.org/search" class="searchbar-form visible-md visible-lg search-form form-horizontal">
                   <input type="hidden" name="size" id="metacpan_search-size" value="20">
                  <div class="form-group">
                      <div class="search-group">
                        <i class="fa fa-search"></i>
                        <input type="text" name="q" placeholder="Search the CPAN" size="41" autocorrect="off" autocapitalize="off" spellcheck="false" id="metacpan_search-input" class="form-control" value="">
                      </div>
                  </div>
                </form>
                    <li class="icon-slidepanel visible-xs visible-sm">
                      <button data-toggle="slidepanel" data-target=".slidepanel">
                        <span class="button-fa-icon">
                          <i class="fa fa-bars slidepanel-open"></i>
                          <i class="fa fa-times slidepanel-close"></i>
                        </span>
                      </button>
                    </li>
                <form action="https://metacpan.org/account/logout" method="POST" id="metacpan-logout"></form>
                <li class="dropdown logged_in" style="display: none;">
                    <button type="button" class="dropdown-toggle" data-toggle="dropdown">
                      <i class="fa fa-user button-fa-icon logged-in-icon" aria-hidden="true"></i>
                      <i class="fas fa-chevron-down"></i>
                    </button>
                    <ul class="dropdown-menu">
                        <li><a href="https://metacpan.org/account/identities">Identities</a></li>
                        <li><a href="https://metacpan.org/account/profile">Profile</a></li>
                        <li><a href="https://metacpan.org/account/favorite/list">Favorites</a></li>
                        <li>
                            <a href="./Data::Validate::IP.html#" type="button" onclick="$('#metacpan-logout').submit(); return false">
                              Logout
                            </a>
                        </li>
                    </ul>
                </li>
                <li class="dropdown logged_out" style="display: none;">
                    <button type="button" class="dropdown-toggle" data-toggle="dropdown">
                      <i class="fa fa-user button-fa-icon" aria-hidden="true"></i>
                      <i class="fas fa-chevron-down"></i>
                    </button>
                    <ul class="dropdown-menu">
                        <li>
                            <a href="https://metacpan.org/login/github">
                                <i class="fab fa-github fa-fw"></i>
                                GitHub
                            </a>
                        </li>
                        <li>
                            <a href="https://metacpan.org/login/twitter">
                                <i class="fab fa-twitter fa-fw"></i>
                                Twitter
                            </a>
                        </li>
                        <li>
                            <a href="https://metacpan.org/login/google">
                                <i class="fab fa-google fa-fw"></i>
                                Google
                            </a>
                        </li>
                    </ul>
                </li>
                <li class="dropdown logged_placeholder">
                    <button>
                      <i class="fa fa-user button-fa-icon" aria-hidden="true"></i>
                    </button>
                </li>
            </ul>
        </nav>
        <div class="page-content ">
          <!--
          <div class="top-notify-banner">
            <i class="fas fa-info-circle"></i>
          </div>
          -->
          <nav class="sidebar">
            <div class="slidepanel">
              <ul class="nav-list ">
    <li class="nav-header no-margin-top">
      <div class="ttip" data-toggle="tooltip" data-placement="bottom" title="The date that this version of Data-Validate-IP was released.">
      <span class="relatize">28 Nov 2022 18:19:55 UTC</span>
    </li>
  <li>
    Distribution: <a href="https://metacpan.org/dist/Data-Validate-IP">Data-Validate-IP</a>
  </li>
  <li>
    Module version: 0.31
  </li>
  <li>
    <a data-keyboard-shortcut="g s" href="https://metacpan.org/dist/Data-Validate-IP/source/lib/Data/Validate/IP.pm">Source</a>
    (<a href="https://metacpan.org/dist/Data-Validate-IP/source/lib/Data/Validate/IP.pm?raw=1">raw</a>)
  </li>
  <li>
    <a data-keyboard-shortcut="g b" href="https://metacpan.org/dist/Data-Validate-IP/source/lib/Data/Validate">Browse</a>
    (<a href="https://metacpan.org/dist/Data-Validate-IP/source/lib/Data/Validate?raw=1">raw</a>)
  </li>
    <li>
      <a data-keyboard-shortcut="g c" href="https://metacpan.org/dist/Data-Validate-IP/changes">Changes</a>
    </li>
    <li>
      <a rel="noopener nofollow" class="nopopup" href="https://metacpan.org/release/Data-Validate-IP">Homepage</a>
    </li>
    <li>
      <a class="nopopup" href="https://metacpan.org/dist/Data-Validate-IP/contribute">How to Contribute</a>
    </li>
    <li>
        <a rel="noopener nofollow" data-keyboard-shortcut="g r" href="https://github.com/houseabsolute/Data-Validate-IP">Repository</a>
    </li>
    <li>
      <a rel="noopener nofollow" data-keyboard-shortcut="g i" href="https://github.com/houseabsolute/Data-Validate-IP/issues">Issues</a>
      (3)
    </li>
    <li>
      <a rel="noopener nofollow" href="http://matrix.cpantesters.org/?dist=Data-Validate-IP+0.31" title="Matrix">Testers</a>
        <span title="(pass / fail / na)">(<a rel="noopener nofollow" href="https://www.cpantesters.org/distro/D/Data-Validate-IP.html?oncpan=1&amp;distmat=1&amp;version=0.31&amp;grade=2" style="color: #090">416</a> / <a rel="noopener nofollow" href="https://www.cpantesters.org/distro/D/Data-Validate-IP.html?oncpan=1&amp;distmat=1&amp;version=0.31&amp;grade=3" style="color: #900">0</a> / <a rel="noopener nofollow" href="https://www.cpantesters.org/distro/D/Data-Validate-IP.html?oncpan=1&amp;distmat=1&amp;version=0.31&amp;grade=4">0</a>)</span>
    </li>
    <li>
      <a rel="noopener nofollow" href="http://cpants.cpanauthors.org/release/DROLSKY/Data-Validate-IP-0.31">Kwalitee</a>
    </li>
    <li>
      <div class="ttip" data-toggle="tooltip" data-placement="bottom" title="The # people with an indexing permission on Data-Validate-IP who have released something to CPAN in the last 2 years (i.e. the # people likely able to release critical fixes in a timely manner)">
      Bus factor: 1
      </div>
    </li>
    <li>
      <a rel="noopener nofollow" href="http://cpancover.com/latest/Data-Validate-IP-0.31/index.html">95.53% Coverage </a>
    </li>
    <li>
      License: perl_5
    </li>
    <li>
      Perl: v5.8.0
    </li>
    <li class="nav-header">Activity</li>
    <li>
<div class="activity-graph">
    <img src="https://metacpan.org/dist/Data-Validate-IP/activity.svg?res=month" />
    <div class="comment">24 month</div>
</div>
    </li>
    <li class="nav-header">Tools</li>
    <li>
      <a itemprop="downloadUrl" href="https://cpan.metacpan.org/authors/id/D/DR/DROLSKY/Data-Validate-IP-0.31.tar.gz">
      Download (<span itemprop="fileSize">42.46KB</span>)</a>
    </li>
    <li>
      <a href="https://explorer.metacpan.org/?url=%2Fmodule%2FDROLSKY%2FData-Validate-IP-0.31%2Flib%2FData%2FValidate%2FIP.pm">
        MetaCPAN Explorer
      </a>
    </li>
    <li>
      <a href="https://metacpan.org/dist/Data-Validate-IP/permissions">
        Permissions
      </a>
    </li>
    <li>
      <a href="https://metacpan.org/dist/Data-Validate-IP/releases.rss">
        Subscribe to distribution
      </a>
    </li>
    <li>
      <button class="btn btn-link" data-toggle="modal" data-target="#metacpan_install-instructions-dialog">
        Install Instructions
      </button>
    </li>
    <li>
      <form action="https://metacpan.org/search">
        <input type="hidden" name="q" value="dist:Data-Validate-IP">
        <input type="search" name="q" placeholder="Search distribution" class="form-control tool-bar-form">
        <input type="submit" style="display: none">
      </form>
    </li>
    <li>
      <form action="https://grep.metacpan.org/search">
        <input type="hidden" name="qd" value="Data-Validate-IP">
        <input type="hidden" name="source" value="metacpan">
        <input type="search" name="q" placeholder="grep distribution" class="form-control tool-bar-form">
        <input type="submit" style="display: none">
     </form>
    </li>
    <li class="version-jump">
<select onchange="document.location.href=&#39;/release/&#39;+this.value+&#39;/view/lib/Data/Validate/IP.pm&#39;" class="form-control tool-bar-form">
  <option disabled selected>Jump to version</option>
<option
  disabled
  value="DROLSKY/Data-Validate-IP-0.31"
>0.31
  (DROLSKY on 2022-11-28)</option>
<option
  
  value="DROLSKY/Data-Validate-IP-0.30"
>0.30
  (DROLSKY on 2021-03-29)</option>
<option
  
  value="DROLSKY/Data-Validate-IP-0.29"
>0.29
  (DROLSKY on 2021-03-29)</option>
<option
  
  value="DROLSKY/Data-Validate-IP-0.28"
>0.28
  (DROLSKY on 2021-03-29)</option>
<option
  
  value="DROLSKY/Data-Validate-IP-0.27"
>0.27
  (DROLSKY on 2016-11-17)</option>
<option
  
  value="DROLSKY/Data-Validate-IP-0.26"
>0.26
  (DROLSKY on 2016-05-31)</option>
<option
  
  value="NEELY/Data-Validate-IP-0.14"
>0.14
  (NEELY on 2011-01-06)</option>
<option
  
  value="NEELY/Data-Validate-IP-0.13"
>0.13
  (NEELY on 2011-01-06)</option>
<option
  
  value="NEELY/Data-Validate-IP-0.12"
>0.12
  (NEELY on 2010-12-29)</option>
<option
  
  value="NEELY/Data-Validate-IP-0.11"
>0.11
  (NEELY on 2010-03-01)</option>
<option
  
  value="NEELY/Data-Validate-IP-0.10"
>0.10
  (NEELY on 2009-06-04)</option>
<optgroup label="BackPAN">'
<option
  
  value="DROLSKY/Data-Validate-IP-0.25"
>0.25
  (DROLSKY on 2016-02-02)</option>
<option
  
  value="DROLSKY/Data-Validate-IP-0.24"
>0.24
  (DROLSKY on 2014-08-28)</option>
<option
  
  value="DROLSKY/Data-Validate-IP-0.23"
>0.23
  (DROLSKY on 2014-03-09)</option>
<option
  
  value="DROLSKY/Data-Validate-IP-0.22"
>0.22
  (DROLSKY on 2013-12-05)</option>
<option
  
  value="DROLSKY/Data-Validate-IP-0.21"
>0.21
  (DROLSKY on 2013-12-05)</option>
<option
  
  value="DROLSKY/Data-Validate-IP-0.20"
>0.20
  (DROLSKY on 2013-07-13)</option>
<option
  
  value="DROLSKY/Data-Validate-IP-0.19"
>0.19
  (DROLSKY on 2013-03-13)</option>
<option
  
  value="DROLSKY/Data-Validate-IP-0.18"
>0.18
  (DROLSKY on 2013-02-20)</option>
<option
  
  value="DROLSKY/Data-Validate-IP-0.17"
>0.17
  (DROLSKY on 2013-02-19)</option>
<option
  
  value="DROLSKY/Data-Validate-IP-0.16-TRIAL"
>0.16-TRIAL DEV
  (DROLSKY on 2013-02-06)</option>
<option
  
  value="DROLSKY/Data-Validate-IP-0.15-TRIAL"
>0.15-TRIAL DEV
  (DROLSKY on 2013-02-05)</option>
<option
  
  value="NEELY/Data-Validate-IP-0.08"
>0.08
  (NEELY on 2007-12-06)</option>
<option
  
  value="NEELY/Data-Validate-IP-0.07"
>0.07
  (NEELY on 2007-05-18)</option>
<option
  
  value="NEELY/Data-Validate-IP-0.06"
>0.06
  (NEELY on 2007-05-16)</option>
<option
  
  value="NEELY/Data-Validate-IP-0.05"
>0.05
  (NEELY on 2007-03-06)</option>
<option
  
  value="NEELY/Data-Validate-IP-0.04"
>0.04
  (NEELY on 2005-04-28)</option>
<option
  
  value="NEELY/Data-Validate-IP-0.03"
>0.03
  (NEELY on 2005-03-04)</option>
<option
  
  value="NEELY/Data-Validate-IP-0.02"
>0.02
  (NEELY on 2005-03-04)</option>
</optgroup>
</select>
    </li>
    <li class="version-diff">
<select onchange="document.location.href='/release/DROLSKY/Data-Validate-IP-0.31/diff/' + encodeURIComponent(this.value) + '/lib/Data/Validate/IP.pm'
" class="form-control tool-bar-form">
  <option disabled selected>Diff with version</option>
<option
  disabled
  value="DROLSKY/Data-Validate-IP-0.31"
>0.31
  (DROLSKY on 2022-11-28)</option>
<option
  
  value="DROLSKY/Data-Validate-IP-0.30"
>0.30
  (DROLSKY on 2021-03-29)</option>
<option
  
  value="DROLSKY/Data-Validate-IP-0.29"
>0.29
  (DROLSKY on 2021-03-29)</option>
<option
  
  value="DROLSKY/Data-Validate-IP-0.28"
>0.28
  (DROLSKY on 2021-03-29)</option>
<option
  
  value="DROLSKY/Data-Validate-IP-0.27"
>0.27
  (DROLSKY on 2016-11-17)</option>
<option
  
  value="DROLSKY/Data-Validate-IP-0.26"
>0.26
  (DROLSKY on 2016-05-31)</option>
<option
  
  value="NEELY/Data-Validate-IP-0.14"
>0.14
  (NEELY on 2011-01-06)</option>
<option
  
  value="NEELY/Data-Validate-IP-0.13"
>0.13
  (NEELY on 2011-01-06)</option>
<option
  
  value="NEELY/Data-Validate-IP-0.12"
>0.12
  (NEELY on 2010-12-29)</option>
<option
  
  value="NEELY/Data-Validate-IP-0.11"
>0.11
  (NEELY on 2010-03-01)</option>
<option
  
  value="NEELY/Data-Validate-IP-0.10"
>0.10
  (NEELY on 2009-06-04)</option>
<optgroup label="BackPAN">'
<option
  
  value="DROLSKY/Data-Validate-IP-0.25"
>0.25
  (DROLSKY on 2016-02-02)</option>
<option
  
  value="DROLSKY/Data-Validate-IP-0.24"
>0.24
  (DROLSKY on 2014-08-28)</option>
<option
  
  value="DROLSKY/Data-Validate-IP-0.23"
>0.23
  (DROLSKY on 2014-03-09)</option>
<option
  
  value="DROLSKY/Data-Validate-IP-0.22"
>0.22
  (DROLSKY on 2013-12-05)</option>
<option
  
  value="DROLSKY/Data-Validate-IP-0.21"
>0.21
  (DROLSKY on 2013-12-05)</option>
<option
  
  value="DROLSKY/Data-Validate-IP-0.20"
>0.20
  (DROLSKY on 2013-07-13)</option>
<option
  
  value="DROLSKY/Data-Validate-IP-0.19"
>0.19
  (DROLSKY on 2013-03-13)</option>
<option
  
  value="DROLSKY/Data-Validate-IP-0.18"
>0.18
  (DROLSKY on 2013-02-20)</option>
<option
  
  value="DROLSKY/Data-Validate-IP-0.17"
>0.17
  (DROLSKY on 2013-02-19)</option>
<option
  
  value="DROLSKY/Data-Validate-IP-0.16-TRIAL"
>0.16-TRIAL DEV
  (DROLSKY on 2013-02-06)</option>
<option
  
  value="DROLSKY/Data-Validate-IP-0.15-TRIAL"
>0.15-TRIAL DEV
  (DROLSKY on 2013-02-05)</option>
<option
  
  value="NEELY/Data-Validate-IP-0.08"
>0.08
  (NEELY on 2007-12-06)</option>
<option
  
  value="NEELY/Data-Validate-IP-0.07"
>0.07
  (NEELY on 2007-05-18)</option>
<option
  
  value="NEELY/Data-Validate-IP-0.06"
>0.06
  (NEELY on 2007-05-16)</option>
<option
  
  value="NEELY/Data-Validate-IP-0.05"
>0.05
  (NEELY on 2007-03-06)</option>
<option
  
  value="NEELY/Data-Validate-IP-0.04"
>0.04
  (NEELY on 2005-04-28)</option>
<option
  
  value="NEELY/Data-Validate-IP-0.03"
>0.03
  (NEELY on 2005-03-04)</option>
<option
  
  value="NEELY/Data-Validate-IP-0.02"
>0.02
  (NEELY on 2005-03-04)</option>
</optgroup>
</select>
    </li>

    <li>
<ul class="dependencies">
  <li class="nav-header">Dependencies</li>
  <li><a href="https://metacpan.org/pod/Exporter" title="Exporter" class="ellipsis">Exporter</a></li>
  <li><a href="https://metacpan.org/pod/NetAddr::IP" title="NetAddr::IP" class="ellipsis">NetAddr::IP</a></li>
  <li><a href="https://metacpan.org/pod/Scalar::Util" title="Scalar::Util" class="ellipsis">Scalar::Util</a></li>
  <li><a href="https://metacpan.org/pod/base" title="base" class="ellipsis">base</a></li>
  <li><a href="https://metacpan.org/pod/strict" title="strict" class="ellipsis">strict</a></li>
  <li><a href="https://metacpan.org/pod/warnings" title="warnings" class="ellipsis">warnings</a></li>
  <li>
    <hr>
  </li>
  <li>
    <a href="https://metacpan.org/module/Data::Validate::IP/requires">Reverse dependencies</a>
  </li>
  <li>
    <a href="http://deps.cpantesters.org/?module=Data%3A%3AValidate%3A%3AIP">CPAN Testers List</a>
  </li>
  <li>
    <a href="https://cpandeps.grinnz.com/?dist=Data-Validate-IP">Dependency graph</a>
  </li>
</ul>
    </li>
    <li class="nav-header">Permalinks</li>
    <li>
      <a href="https://metacpan.org/release/DROLSKY/Data-Validate-IP-0.31/view/lib/Data/Validate/IP.pm">This version</a>
    </li>
    <li>
      <a href="./Data::Validate::IP.html">Latest version</a>
    </li>
    <li>
<div class="plussers">
<div class="nav-header">++ed by:</div>
<div>
<a class="display-all" href="https://metacpan.org/author/PHIPSTER"><img src="https://www.gravatar.com/avatar/06bb32ae5d904656d37036e271849751?d=identicon&amp;s=20" title="PHIPSTER" alt="PHIPSTER"></a>
<a class="display-all" href="https://metacpan.org/author/KES"><img src="https://www.gravatar.com/avatar/e8530f00b43b4f6a056f8ad4ee52ea47?d=identicon&amp;s=20" title="KES" alt="KES"></a>
<a class="display-all" href="https://metacpan.org/author/LUCAS"><img src="https://www.gravatar.com/avatar/289426c9d3c2ee28c2d157d4401e14db?d=identicon&amp;s=20" title="LUCAS" alt="LUCAS"></a>
<a class="display-all" href="https://metacpan.org/author/ALEXPAN"><img src="https://www.gravatar.com/avatar/70e0ed15dcfbb2cf0e09fbb0d09c9bf8?d=identicon&amp;s=20" title="ALEXPAN" alt="ALEXPAN"></a>
<a class="display-all" href="https://metacpan.org/author/BKB"><img src="https://www.gravatar.com/avatar/191945c6c283d81db701008b2d89b68c?d=identicon&amp;s=20" title="BKB" alt="BKB"></a>
</div>
<!-- Display counts of plussers-->
<div>
    <a href="https://metacpan.org/dist/Data-Validate-IP/plussers">10 PAUSE users</a>
</div>
<div>
    2 non-PAUSE users
</div>
</div>
    </li>
    <li>
<div id="metacpan_contributors">
  <div>
    <button class="btn-link"
      onclick="$(this).hide(); $('#metacpan_contributors ul').slideDown(); return false;"
    >and 2 contributors</button>
  </div>
  <ul style="display: none">
    <li class="contributor"
      data-cpan-author="NEELY"
      data-contrib-email="neil@neely.cx"
    >
      <a href="https://metacpan.org/author/NEELY" class="cpan-author">
      <img class="gravatar" width="20" height="20" src="https://www.gravatar.com/avatar/4f79a358308270fcae6d98b7f0a019d5?d=identicon&amp;s=20" />
      Neil Neely
      </a>
    </li>
    <li class="contributor"
      data-cpan-author="OSCHWALD"
      data-contrib-email="goschwald@maxmind.com"
    >
      <a href="https://metacpan.org/author/OSCHWALD" class="cpan-author">
      <img class="gravatar" width="20" height="20" src="https://www.gravatar.com/avatar/2c092000b26ce71a7beb2161da998468?d=identicon&amp;s=20" />
      Gregory Oschwald
      </a>
    </li>
  </ul>
</div>
    </li>
              </ul>
            </div>
          </nav>
          <div class="content-navigation">
<div class="breadcrumbs">
  <span>
    <a data-keyboard-shortcut="g a" rel="author" href="https://metacpan.org/author/DROLSKY" class="author-name">Dave Rolsky</a>
  </span>
  <span>&nbsp;/&nbsp;</span>
  <div class="release dist-release status-latest maturity-released">
    <span class="dropdown"><b class="caret"></b></span>
<select onchange="document.location.href=&#39;/release/&#39;+this.value+&#39;/view/lib/Data/Validate/IP.pm&#39;" class="">
<option
  selected
  value="DROLSKY/Data-Validate-IP-0.31"
>0.31
  (DROLSKY on 2022-11-28)</option>
<option
  
  value="DROLSKY/Data-Validate-IP-0.30"
>0.30
  (DROLSKY on 2021-03-29)</option>
<option
  
  value="DROLSKY/Data-Validate-IP-0.29"
>0.29
  (DROLSKY on 2021-03-29)</option>
<option
  
  value="DROLSKY/Data-Validate-IP-0.28"
>0.28
  (DROLSKY on 2021-03-29)</option>
<option
  
  value="DROLSKY/Data-Validate-IP-0.27"
>0.27
  (DROLSKY on 2016-11-17)</option>
<option
  
  value="DROLSKY/Data-Validate-IP-0.26"
>0.26
  (DROLSKY on 2016-05-31)</option>
<option
  
  value="NEELY/Data-Validate-IP-0.14"
>0.14
  (NEELY on 2011-01-06)</option>
<option
  
  value="NEELY/Data-Validate-IP-0.13"
>0.13
  (NEELY on 2011-01-06)</option>
<option
  
  value="NEELY/Data-Validate-IP-0.12"
>0.12
  (NEELY on 2010-12-29)</option>
<option
  
  value="NEELY/Data-Validate-IP-0.11"
>0.11
  (NEELY on 2010-03-01)</option>
<option
  
  value="NEELY/Data-Validate-IP-0.10"
>0.10
  (NEELY on 2009-06-04)</option>
<optgroup label="BackPAN">'
<option
  
  value="DROLSKY/Data-Validate-IP-0.25"
>0.25
  (DROLSKY on 2016-02-02)</option>
<option
  
  value="DROLSKY/Data-Validate-IP-0.24"
>0.24
  (DROLSKY on 2014-08-28)</option>
<option
  
  value="DROLSKY/Data-Validate-IP-0.23"
>0.23
  (DROLSKY on 2014-03-09)</option>
<option
  
  value="DROLSKY/Data-Validate-IP-0.22"
>0.22
  (DROLSKY on 2013-12-05)</option>
<option
  
  value="DROLSKY/Data-Validate-IP-0.21"
>0.21
  (DROLSKY on 2013-12-05)</option>
<option
  
  value="DROLSKY/Data-Validate-IP-0.20"
>0.20
  (DROLSKY on 2013-07-13)</option>
<option
  
  value="DROLSKY/Data-Validate-IP-0.19"
>0.19
  (DROLSKY on 2013-03-13)</option>
<option
  
  value="DROLSKY/Data-Validate-IP-0.18"
>0.18
  (DROLSKY on 2013-02-20)</option>
<option
  
  value="DROLSKY/Data-Validate-IP-0.17"
>0.17
  (DROLSKY on 2013-02-19)</option>
<option
  
  value="DROLSKY/Data-Validate-IP-0.16-TRIAL"
>0.16-TRIAL DEV
  (DROLSKY on 2013-02-06)</option>
<option
  
  value="DROLSKY/Data-Validate-IP-0.15-TRIAL"
>0.15-TRIAL DEV
  (DROLSKY on 2013-02-05)</option>
<option
  
  value="NEELY/Data-Validate-IP-0.08"
>0.08
  (NEELY on 2007-12-06)</option>
<option
  
  value="NEELY/Data-Validate-IP-0.07"
>0.07
  (NEELY on 2007-05-18)</option>
<option
  
  value="NEELY/Data-Validate-IP-0.06"
>0.06
  (NEELY on 2007-05-16)</option>
<option
  
  value="NEELY/Data-Validate-IP-0.05"
>0.05
  (NEELY on 2007-03-06)</option>
<option
  
  value="NEELY/Data-Validate-IP-0.04"
>0.04
  (NEELY on 2005-04-28)</option>
<option
  
  value="NEELY/Data-Validate-IP-0.03"
>0.03
  (NEELY on 2005-03-04)</option>
<option
  
  value="NEELY/Data-Validate-IP-0.02"
>0.02
  (NEELY on 2005-03-04)</option>
</optgroup>
</select>
    <a data-keyboard-shortcut="g d" class="release-name" href="https://metacpan.org/dist/Data-Validate-IP">Data-Validate-IP-0.31</a>
  </div>
<span class="river-gauge-gauge">
  <svg width="24px"
       height="15px"
       version="1.1"
       xmlns="http://www.w3.org/2000/svg"
       xmlns:xlink="http://www.w3.org/1999/xlink">

    <g>
      <title>        River stage two &#10;
          • 23 direct dependents &#10;          • 62 total dependents
      </title>

      <rect x="0"  y="0" width="4" height="15" fill="#7ea3f2" />
      <rect x="5"  y="0" width="4" height="15" fill="#7ea3f2" />
      <rect x="10"  y="0" width="4" height="15" fill="#e4e2e2" />
      <rect x="15"  y="0" width="4" height="15" fill="#e4e2e2" />
      <rect x="20"  y="0" width="4" height="15" fill="#e4e2e2" />
    </g>
  </svg>

</span>
<div id="Data-Validate-IP-fav" class="logged_in">
<form action="https://metacpan.org/account/favorite/add" style="display: inline" onsubmit="return favDistribution(this)">
    <input type="hidden" name="remove" value="0">
    <input type="hidden" name="release" value="Data-Validate-IP-0.31">
    <input type="hidden" name="author" value="DROLSKY">
    <input type="hidden" name="distribution" value="Data-Validate-IP">
    <button type="submit" class="favorite highlight"><span>12</span> ++</button>
</form>
</div>
<div class="logged_out">
<a href="./Data::Validate::IP.html" onclick="alert('Please sign in to add favorites'); return false" class="favorite highlight">
<span>12</span> ++</a>
</div>
   / <span>Data::Validate::IP</span>
</div>
          </div>
          <main class="content">


<nav class="toc">
  <div class="toc-header"><strong>Contents</strong></div>
<ul>
  <li><a href="./Data::Validate::IP.html#NAME">NAME</a></li>
  <li><a href="./Data::Validate::IP.html#VERSION">VERSION</a></li>
  <li><a href="./Data::Validate::IP.html#SYNOPSIS">SYNOPSIS</a></li>
  <li><a href="./Data::Validate::IP.html#DESCRIPTION">DESCRIPTION</a></li>
  <li><a href="./Data::Validate::IP.html#USAGE-AND-SECURITY-RECOMMENDATIONS">USAGE AND SECURITY RECOMMENDATIONS</a></li>
  <li><a href="./Data::Validate::IP.html#FUNCTIONS">FUNCTIONS</a>
    <ul>
      <li><a href="./Data::Validate::IP.html#is_ipv4($ip),-is_ipv6($ip),-is_ip($ip)">is_ipv4($ip), is_ipv6($ip), is_ip($ip)</a></li>
      <li><a href="./Data::Validate::IP.html#is_innet_ipv4($ip,-$network)">is_innet_ipv4($ip, $network)</a></li>
      <li><a href="./Data::Validate::IP.html#is_unroutable_ipv4($ip)">is_unroutable_ipv4($ip)</a></li>
      <li><a href="./Data::Validate::IP.html#is_private_ipv4($ip)">is_private_ipv4($ip)</a></li>
      <li><a href="./Data::Validate::IP.html#is_loopback_ipv4($ip)">is_loopback_ipv4($ip)</a></li>
      <li><a href="./Data::Validate::IP.html#is_linklocal_ipv4($ip)">is_linklocal_ipv4($ip)</a></li>
      <li><a href="./Data::Validate::IP.html#is_testnet_ipv4($ip)">is_testnet_ipv4($ip)</a></li>
      <li><a href="./Data::Validate::IP.html#is_anycast_ipv4($ip)">is_anycast_ipv4($ip)</a></li>
      <li><a href="./Data::Validate::IP.html#is_multicast_ipv4($ip)">is_multicast_ipv4($ip)</a></li>
      <li><a href="./Data::Validate::IP.html#is_loopback_ipv6($ip)">is_loopback_ipv6($ip)</a></li>
      <li><a href="./Data::Validate::IP.html#is_ipv4_mapped_ipv6($ip)">is_ipv4_mapped_ipv6($ip)</a></li>
      <li><a href="./Data::Validate::IP.html#is_discard_ipv6($ip)">is_discard_ipv6($ip)</a></li>
      <li><a href="./Data::Validate::IP.html#is_special_ipv6($ip)">is_special_ipv6($ip)</a></li>
      <li><a href="./Data::Validate::IP.html#is_teredo_ipv6($ip)">is_teredo_ipv6($ip)</a></li>
      <li><a href="./Data::Validate::IP.html#is_orchid_ipv6($ip)">is_orchid_ipv6($ip)</a></li>
      <li><a href="./Data::Validate::IP.html#is_documentation_ipv6($ip)">is_documentation_ipv6($ip)</a></li>
      <li><a href="./Data::Validate::IP.html#is_unspecified_ipv6($ip)">is_unspecified_ipv6($ip)</a></li>
      <li><a href="./Data::Validate::IP.html#is_private_ipv6($ip)">is_private_ipv6($ip)</a></li>
      <li><a href="./Data::Validate::IP.html#is_linklocal_ipv6($ip)">is_linklocal_ipv6($ip)</a></li>
      <li><a href="./Data::Validate::IP.html#is_multicast_ipv6($ip)">is_multicast_ipv6($ip)</a></li>
      <li><a href="./Data::Validate::IP.html#is_public_ipv4($ip),-is_public_ipv6($ip),-is_public_ip($ip)">is_public_ipv4($ip), is_public_ipv6($ip), is_public_ip($ip)</a></li>
      <li><a href="./Data::Validate::IP.html#is_linklocal_ip($ip)">is_linklocal_ip($ip)</a></li>
      <li><a href="./Data::Validate::IP.html#is_loopback_ip($ip)">is_loopback_ip($ip)</a></li>
      <li><a href="./Data::Validate::IP.html#is_multicast_ip($ip)">is_multicast_ip($ip)</a></li>
      <li><a href="./Data::Validate::IP.html#is_private_ip($ip)">is_private_ip($ip)</a></li>
    </ul>
  </li>
  <li><a href="./Data::Validate::IP.html#OBJECT-ORIENTED-INTERFACE">OBJECT-ORIENTED INTERFACE</a></li>
  <li><a href="./Data::Validate::IP.html#SEE-ALSO">SEE ALSO</a></li>
  <li><a href="./Data::Validate::IP.html#ACKNOWLEDGEMENTS">ACKNOWLEDGEMENTS</a></li>
  <li><a href="./Data::Validate::IP.html#BUGS">BUGS</a></li>
  <li><a href="./Data::Validate::IP.html#SOURCE">SOURCE</a></li>
  <li><a href="./Data::Validate::IP.html#AUTHORS">AUTHORS</a></li>
  <li><a href="./Data::Validate::IP.html#CONTRIBUTOR">CONTRIBUTOR</a></li>
  <li><a href="./Data::Validate::IP.html#COPYRIGHT-AND-LICENSE">COPYRIGHT AND LICENSE</a></li>
</ul></nav>
<div class="pod anchors">
<h1 id="NAME">NAME</h1>

<p>Data::Validate::IP - IPv4 and IPv6 validation methods</p>

<h1 id="VERSION">VERSION</h1>

<p>version 0.31</p>

<h1 id="SYNOPSIS">SYNOPSIS</h1>

<pre><code>  use Data::Validate::IP qw(is_ipv4 is_ipv6);

  my $suspect = &#39;1.2.3.4&#39;;
  if (is_ipv4($suspect)) {
      print &quot;Looks like an IPv4 address&quot;;
  }
  else {
      print &quot;Not an IPv4 address\n&quot;;
  }

  $suspect = &#39;::1234&#39;;
  if (is_ipv6($suspect)) {
      print &quot;Looks like an IPv6 address&quot;;
  }
  else {
      print &quot;Not an IPv6 address\n&quot;;
  }</code></pre>

<h1 id="DESCRIPTION">DESCRIPTION</h1>

<p>This module provides a number IP address validation subs that both validate and untaint their input. This includes both basic validation (<code>is_ipv4()</code> and <code>is_ipv6()</code>) and special cases like checking whether an address belongs to a specific network or whether an address is public or private (reserved).</p>

<h1 id="USAGE-AND-SECURITY-RECOMMENDATIONS"><a id="USAGE"></a>USAGE AND SECURITY RECOMMENDATIONS</h1>

<p>It&#39;s important to understand that if <code>is_ipv4($ip)</code>, <code>is_ipv6($ip)</code>, or <code>is_ip($ip)</code> return false, then all other validation functions for that IP address family will <i>also</i> return false. So for example, if <code>is_ipv4($ip)</code> returns false, then <code>is_private_ipv4($ip)</code> <i>and</i> <code>is_public_ipv4($ip)</code> will both also return false.</p>

<p>This means that simply calling <code>is_private_ipv4($ip)</code> by itself is not sufficient if you are dealing with untrusted input. You should always check <code>is_ipv4($ip)</code> as well. This applies as well when using IPv6 functions or generic functions like <code>is_private_ip($ip)</code>.</p>

<p>There are security implications to this around certain oddly formed addresses. Notably, an address like &quot;010.0.0.1&quot; is technically valid, but the operating system will treat &quot;010&quot; as an octal number. That means that &quot;010.0.0.1&quot; is equivalent to &quot;8.0.0.1&quot;, <i>not</i> &quot;10.0.0.1&quot;.</p>

<p>However, this module&#39;s <code>is_ipv4($ip)</code> and <code>is_ip($ip)</code> functions will return false for addresses like &quot;010.0.0.1&quot; which have octal components. And of course that means that it also returns false for <code>is_private_ipv4($ip)</code> <i>and</i> <code>is_public_ipv4($ip)</code>.</p>

<h1 id="FUNCTIONS">FUNCTIONS</h1>

<p>All of the functions below are exported by default.</p>

<p>All functions return an untainted value if the test passes and undef if it fails. In theory, this means that you should always check for a defined status explicitly but in practice there are no valid IP addresses where the string form evaluates to false in Perl.</p>

<p>Note that none of these functions actually attempt to test whether the given IP address is routable from your device; they are purely semantic checks.</p>

<h2 id="is_ipv4($ip),-is_ipv6($ip),-is_ip($ip)"><a id="is_ipv4"></a><a id="is_ipv4-ip--is_ipv6-ip--is_ip-ip"></a>is_ipv4($ip), is_ipv6($ip), is_ip($ip)</h2>

<p>These functions simply check whether the address is a valid IPv4 or IPv6 address.</p>

<h2 id="is_innet_ipv4($ip,-$network)"><a id="is_innet_ipv4"></a><a id="is_innet_ipv4-ip---network"></a>is_innet_ipv4($ip, $network)</h2>

<p>This subroutine checks whether the address belongs to the given IPv4 network. The <code>$network</code> argument can either be a string in CIDR notation like &quot;15.0.15.0/24&quot; or a <a href="https://metacpan.org/pod/NetAddr::IP">NetAddr::IP</a> object.</p>

<p>This subroutine used to accept many more forms of network specifications (anything <a href="https://metacpan.org/pod/Net::Netmask">Net::Netmask</a> accepts) but this has been deprecated.</p>

<h2 id="is_unroutable_ipv4($ip)"><a id="is_unroutable_ipv4"></a><a id="is_unroutable_ipv4-ip"></a>is_unroutable_ipv4($ip)</h2>

<p>This subroutine checks whether the address belongs to any of several special use IPv4 networks - <code>0.0.0.0/8</code>, <code>100.64.0.0/10</code>, <code>192.0.0.0/29</code>, <code>198.18.0.0/15</code>, <code>240.0.0.0/4</code> - as defined by <a href="http://tools.ietf.org/html/rfc5735">RFC 5735</a>, <a href="http://tools.ietf.org/html/rfc6333">RFC 6333</a>, and <a href="http://tools.ietf.org/html/rfc6598">RFC 6958</a>.</p>

<p>Arguably, these should be broken down further but this subroutine will always exist for backwards compatibility.</p>

<h2 id="is_private_ipv4($ip)"><a id="is_private_ipv4"></a><a id="is_private_ipv4-ip"></a>is_private_ipv4($ip)</h2>

<p>This subroutine checks whether the address belongs to any of the private IPv4 networks - <code>10.0.0.0/8</code>, <code>172.16.0.0/12</code>, <code>192.168.0.0/16</code> - as defined by <a href="http://tools.ietf.org/html/rfc5735">RFC 5735</a>.</p>

<h2 id="is_loopback_ipv4($ip)"><a id="is_loopback_ipv4"></a><a id="is_loopback_ipv4-ip"></a>is_loopback_ipv4($ip)</h2>

<p>This subroutine checks whether the address belongs to the IPv4 loopback network - <code>127.0.0.0/8</code> - as defined by <a href="http://tools.ietf.org/html/rfc5735">RFC 5735</a>.</p>

<h2 id="is_linklocal_ipv4($ip)"><a id="is_linklocal_ipv4"></a><a id="is_linklocal_ipv4-ip"></a>is_linklocal_ipv4($ip)</h2>

<p>This subroutine checks whether the address belongs to the IPv4 link local network - <code>169.254.0.0/16</code> - as defined by <a href="http://tools.ietf.org/html/rfc5735">RFC 5735</a>.</p>

<h2 id="is_testnet_ipv4($ip)"><a id="is_testnet_ipv4"></a><a id="is_testnet_ipv4-ip"></a>is_testnet_ipv4($ip)</h2>

<p>This subroutine checks whether the address belongs to any of the IPv4 TEST-NET networks for use in documentation and example code - <code>192.0.2.0/24</code>, <code>198.51.100.0/24</code>, and <code>203.0.113.0/24</code> - as defined by <a href="http://tools.ietf.org/html/rfc5735">RFC 5735</a>.</p>

<h2 id="is_anycast_ipv4($ip)"><a id="is_anycast_ipv4"></a><a id="is_anycast_ipv4-ip"></a>is_anycast_ipv4($ip)</h2>

<p>This subroutine checks whether the address belongs to the 6to4 relay anycast network - <code>192.88.99.0/24</code> - as defined by <a href="http://tools.ietf.org/html/rfc5735">RFC 5735</a>.</p>

<h2 id="is_multicast_ipv4($ip)"><a id="is_multicast_ipv4"></a><a id="is_multicast_ipv4-ip"></a>is_multicast_ipv4($ip)</h2>

<p>This subroutine checks whether the address belongs to the IPv4 multicast network - <code>224.0.0.0/4</code> - as defined by <a href="http://tools.ietf.org/html/rfc5735">RFC 5735</a>.</p>

<h2 id="is_loopback_ipv6($ip)"><a id="is_loopback_ipv6"></a><a id="is_loopback_ipv6-ip"></a>is_loopback_ipv6($ip)</h2>

<p>This subroutine checks whether the address is the IPv6 loopback address - <code>::1/128</code> - as defined by <a href="http://tools.ietf.org/html/rfc4291">RFC 4291</a>.</p>

<h2 id="is_ipv4_mapped_ipv6($ip)"><a id="is_ipv4_mapped_ipv6"></a><a id="is_ipv4_mapped_ipv6-ip"></a>is_ipv4_mapped_ipv6($ip)</h2>

<p>This subroutine checks whether the address belongs to the IPv6 IPv4-mapped address network - <code>::ffff:0:0/96</code> - as defined by <a href="http://tools.ietf.org/html/rfc4291">RFC 4291</a>.</p>

<h2 id="is_discard_ipv6($ip)"><a id="is_discard_ipv6"></a><a id="is_discard_ipv6-ip"></a>is_discard_ipv6($ip)</h2>

<p>This subroutine checks whether the address belongs to the IPv6 discard prefix network - <code>100::/64</code> - as defined by <a href="http://tools.ietf.org/html/rfc6666">RFC 6666</a>.</p>

<h2 id="is_special_ipv6($ip)"><a id="is_special_ipv6"></a><a id="is_special_ipv6-ip"></a>is_special_ipv6($ip)</h2>

<p>This subroutine checks whether the address belongs to the IPv6 special network - <code>2001::/23</code> - as defined by <a href="http://tools.ietf.org/html/rfc2928">RFC 2928</a>.</p>

<h2 id="is_teredo_ipv6($ip)"><a id="is_teredo_ipv6"></a><a id="is_teredo_ipv6-ip"></a>is_teredo_ipv6($ip)</h2>

<p>This subroutine checks whether the address belongs to the IPv6 TEREDO network - <code>2001::/32</code> - as defined by <a href="http://tools.ietf.org/html/rfc4380">RFC 4380</a>.</p>

<p>Note that this network is a subnet of the larger special network at <code>2001::/23</code>.</p>

<h2 id="is_orchid_ipv6($ip)"><a id="is_orchid_ipv6"></a><a id="is_orchid_ipv6-ip"></a>is_orchid_ipv6($ip)</h2>

<p>This subroutine checks whether the address belongs to the IPv6 ORCHID network - <code>2001::/32</code> - as defined by <a href="http://tools.ietf.org/html/rfc4380">RFC 4380</a>.</p>

<p>Note that this network is a subnet of the larger special network at <code>2001::/23</code>.</p>

<p>This network is currently scheduled to be returned to the special pool in March of 2014 unless the IETF extends its use. If that happens this subroutine will continue to exist but will always return false.</p>

<h2 id="is_documentation_ipv6($ip)"><a id="is_documentation_ipv6"></a><a id="is_documentation_ipv6-ip"></a>is_documentation_ipv6($ip)</h2>

<p>This subroutine checks whether the address belongs to the IPv6 documentation network - <code>2001:DB8::/32</code> - as defined by <a href="http://tools.ietf.org/html/rfc3849">RFC 3849</a>.</p>

<h2 id="is_unspecified_ipv6($ip)"><a id="is_unspecified_ipv6"></a><a id="is_unspecified_ipv6-ip"></a>is_unspecified_ipv6($ip)</h2>

<p>This subroutine checks whether the address belongs to the IPv6 unspecified network - <code>::0/128</code> - as defined by <a href="http://tools.ietf.org/html/rfc4291">RFC 4291</a>.. Note that the address in this subnet is neither private nor public.</p>

<h2 id="is_private_ipv6($ip)"><a id="is_private_ipv6"></a><a id="is_private_ipv6-ip"></a>is_private_ipv6($ip)</h2>

<p>This subroutine checks whether the address belongs to the IPv6 private network - <code>FC00::/7</code> - as defined by <a href="http://tools.ietf.org/html/rfc4193">RFC 4193</a>.</p>

<h2 id="is_linklocal_ipv6($ip)"><a id="is_linklocal_ipv6"></a><a id="is_linklocal_ipv6-ip"></a>is_linklocal_ipv6($ip)</h2>

<p>This subroutine checks whether the address belongs to the IPv6 link-local unicast network - <code>FE80::/10</code> - as defined by <a href="http://tools.ietf.org/html/rfc4291">RFC 4291</a>.</p>

<h2 id="is_multicast_ipv6($ip)"><a id="is_multicast_ipv6"></a><a id="is_multicast_ipv6-ip"></a>is_multicast_ipv6($ip)</h2>

<p>This subroutine checks whether the address belongs to the IPv6 multicast network - <code>FF00::/8</code> - as defined by <a href="http://tools.ietf.org/html/rfc4291">RFC 4291</a>.</p>

<h2 id="is_public_ipv4($ip),-is_public_ipv6($ip),-is_public_ip($ip)"><a id="is_public_ipv4"></a><a id="is_public_ipv4-ip--is_public_ipv6-ip--is_public_ip-ip"></a>is_public_ipv4($ip), is_public_ipv6($ip), is_public_ip($ip)</h2>

<p>These subroutines check whether the given IP address belongs to any of the special case networks defined previously. Note that this is <b>not</b> simply the opposite of checking <code>is_private_ipv4()</code> or <code>is_private_ipv6()</code>. The private networks are a subset of all the special case networks.</p>

<h2 id="is_linklocal_ip($ip)"><a id="is_linklocal_ip"></a><a id="is_linklocal_ip-ip"></a>is_linklocal_ip($ip)</h2>

<p>This subroutine checks whether the address belongs to the IPv4 or IPv6 link-local unicast network.</p>

<h2 id="is_loopback_ip($ip)"><a id="is_loopback_ip"></a><a id="is_loopback_ip-ip"></a>is_loopback_ip($ip)</h2>

<p>This subroutine checks whether the address is the IPv4 or IPv6 loopback address.</p>

<h2 id="is_multicast_ip($ip)"><a id="is_multicast_ip"></a><a id="is_multicast_ip-ip"></a>is_multicast_ip($ip)</h2>

<p>This subroutine checks whether the address belongs to the IPv4 or IPv6 multicast network.</p>

<h2 id="is_private_ip($ip)"><a id="is_private_ip"></a><a id="is_private_ip-ip"></a>is_private_ip($ip)</h2>

<p>This subroutine checks whether the address belongs to the IPv4 or IPv6 private network.</p>

<h1 id="OBJECT-ORIENTED-INTERFACE"><a id="OBJECT"></a>OBJECT-ORIENTED INTERFACE</h1>

<p>This module can also be used as a class. You can call <code>Data::Validate::IP-&gt;new()</code> to get an object and then call any of the validation subroutines as methods on that object. This is somewhat pointless since the object will never contain any state but this interface is kept for backwards compatibility.</p>

<h1 id="SEE-ALSO"><a id="SEE"></a>SEE ALSO</h1>

<p>IPv4</p>

<p><b>[RFC 5735] [RFC 1918]</b></p>

<p>IPv6</p>

<p><b>[RFC 2460] [RFC 4193] [RFC 4291] [RFC 6434]</b></p>

<h1 id="ACKNOWLEDGEMENTS">ACKNOWLEDGEMENTS</h1>

<p>Thanks to Richard Sonnen &lt;<i>sonnen@richardsonnen.com</i>&gt; for writing the Data::Validate module.</p>

<p>Thanks to Matt Dainty &lt;<i>matt@bodgit-n-scarper.com</i>&gt; for adding the <code>is_multicast_ipv4()</code> and <code>is_linklocal_ipv4()</code> code.</p>

<h1 id="BUGS">BUGS</h1>

<p>Please report any bugs or feature requests to <code>bug-data-validate-ip@rt.cpan.org</code>, or through the web interface at <a href="http://rt.cpan.org">http://rt.cpan.org</a>. I will be notified, and then you&#39;ll automatically be notified of progress on your bug as I make changes.</p>

<p>Bugs may be submitted at <a href="https://github.com/houseabsolute/Data-Validate-IP/issues">https://github.com/houseabsolute/Data-Validate-IP/issues</a>.</p>

<h1 id="SOURCE">SOURCE</h1>

<p>The source code repository for Data-Validate-IP can be found at <a href="https://github.com/houseabsolute/Data-Validate-IP">https://github.com/houseabsolute/Data-Validate-IP</a>.</p>

<h1 id="AUTHORS">AUTHORS</h1>

<ul>

<li><p>Neil Neely &lt;neil@neely.cx&gt;</p>

</li>
<li><p>Dave Rolsky &lt;autarch@urth.org&gt;</p>

</li>
</ul>

<h1 id="CONTRIBUTOR">CONTRIBUTOR</h1>

<p>Gregory Oschwald &lt;goschwald@maxmind.com&gt;</p>

<h1 id="COPYRIGHT-AND-LICENSE"><a id="COPYRIGHT"></a>COPYRIGHT AND LICENSE</h1>

<p>This software is copyright (c) 2022 by Neil Neely.</p>

<p>This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.</p>

<p>The full text of the license can be found in the <i>LICENSE</i> file included with this distribution.</p></div>

<div id="metacpan_install-instructions-dialog" class="modal fade">
  <div class="modal-dialog">
    <div class="modal-content">
      <div class="modal-header">
        <button type="button" class="close" data-dismiss="modal" aria-hidden="true">&times;</button>
        <h4 class="modal-title">Module Install Instructions</h4>
      </div>
      <div class="modal-body">
        <p>To install Data::Validate::IP, copy and paste the appropriate command in to your terminal.</p>
        <p><a href="https://metacpan.org/dist/App-cpanminus/view/bin/cpanm">cpanm</a></p>
        <pre><code>cpanm Data::Validate::IP</code></pre>
        <p><a href="https://metacpan.org/pod/CPAN">CPAN shell</a></p>
        <pre><code>perl -MCPAN -e shell
install Data::Validate::IP</code></pre>
        <p>For more information on module installation, please visit <a href="https://www.cpan.org/modules/INSTALL.html">the detailed CPAN module installation guide</a>.</p>
      </div>
      <div class="modal-footer">
        <a href="./Data::Validate::IP.html#" data-dismiss="modal" class="btn">Close</a>
      </div>
    </div>
  </div>
</div>
          </main>
          <div class="content-pagination">
          </div>
        </div>
        <footer class="footer">
          <div class="footer-container">
            <div class="footer-social">
              <div class="footer-link footer-logo">
                <a href="https://metacpan.org/">
                  <img src="https://metacpan.org/static/images/metacpan-logo.svg" alt="MetaCPAN" />
                </a>
              </div>
              <a class="footer-social-link" href="https://github.com/metacpan">
                <i class="fab fa-github-square"></i>
              </a>
              <a class="footer-social-link" href="https://fosstodon.org/@metacpan">
                <i class="fab fa-mastodon"></i>
              </a>
            </div>
            <div class="footer-links">
              <div class="footer-link">
                  <a href="https://metacpan.org/about">About</a>
              </div>
              <div class="footer-link">
                  <a href="https://metacpan.org/about/sponsors">Sponsor</a>
              </div>
              <div class="footer-link">
                  <a href="https://grep.metacpan.org">grep::cpan</a>
              </div>
              <div class="footer-link">
                  <a href="https://metacpan.org/recent">Recent</a>
              </div>
              <div class="footer-link">
                  <a href="https://metacpan.org/about/faq">FAQ</a>
              </div>
              <div class="footer-link">
                  <a href="https://metacpan.org/tools">Tools</a>
              </div>
              <div class="footer-link">
                  <a href="https://fastapi.metacpan.org/">API</a>
              </div>
              <div class="footer-link">
                  <a href="https://www.perl.org/">Perl.org</a>
              </div>
            </div>
            <div class="footer-sponsors">
              <a class="footer-sponsor-link" target="_blank" href="https://www.bytemark.co.uk/" rel="noopener">
                <img class="footer-sponsor-bytemark" src="https://metacpan.org/static/images/sponsors/bytemark_logo.svg" alt="Bytemark logo">
              </a>
              <a class="footer-sponsor-link" target="_blank" href="https://www.liquidweb.com/" rel="noopener">
                <img class="footer-sponsor-liquidweb" src="https://metacpan.org/static/images/sponsors/liquidweb_logo.png" alt="liquidweb logo">
              </a>
              <a class="footer-sponsor-link" target="_blank" href="https://deriv.com/careers/" rel="noopener">
                <img class="footer-sponsor-deriv" src="https://metacpan.org/static/images/sponsors/deriv.svg" alt="Deriv logo">
              </a>
              <a class="footer-sponsor-link" target="_blank" href="https://geocode.xyz" rel="noopener">
                <img class="footer-sponsor-geocode" src="https://metacpan.org/static/images/sponsors/geocodelogo.svg" alt="Geocode logo">
              </a>
              <a class="footer-sponsor-link" target="_blank" href="https://www.fastly.com/" rel="noopener">
                <img class="footer-sponsor-fastly" src="https://metacpan.org/static/images/sponsors/fastly_logo.svg" alt="Fastly logo">
              </a>
              <a class="footer-sponsor-link" target="_blank" href="https://opencagedata.com" rel="noopener">
                <img class="footer-sponsor-opencage" src="https://metacpan.org/static/images/sponsors/open-cage.svg" alt="OpenCage logo">
              </a>
            </div>
          </div>
        </footer>
        <div class="modal fade" tabindex="-1" role="dialog" id="metacpan_keyboard-shortcuts">
          <div class="modal-dialog">
            <div class="modal-content">
              <div class="modal-header">
                <button type="button" class="close" data-dismiss="modal">&times;</button>
                <h4 class="modal-title">Keyboard Shortcuts</h4>
              </div>
              <div class="modal-body row">
<div class="col-md-6">
  <table class="table keyboard-shortcuts">
    <thead>
      <tr>
        <th></th>
        <th>Global</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td class="keys">
          <kbd>s</kbd>
        </td>
        <td>Focus search bar</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>?</kbd>
        </td>
        <td>Bring up this help dialog</td>
      </tr>
    </tbody>
  </table>

  <table class="table keyboard-shortcuts">
    <thead>
      <tr>
        <th></th>
        <th>GitHub</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>p</kbd>
        </td>
        <td>Go to pull requests</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>i</kbd>
        </td>
        <td>go to github issues (only if github is preferred repository)</td>
      </tr>
    </tbody>
  </table>
</div>

<div class="col-md-6">
  <table class="table keyboard-shortcuts">
    <thead>
      <tr>
        <th></th>
        <th>POD</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>a</kbd>
        </td>
        <td>Go to author</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>c</kbd>
        </td>
        <td>Go to changes</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>i</kbd>
        </td>
        <td>Go to issues</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>d</kbd>
        </td>
        <td>Go to dist</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>r</kbd>
        </td>
        <td>Go to repository/SCM</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>s</kbd>
        </td>
        <td>Go to source</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>b</kbd>
        </td>
        <td>Go to file browse</td>
      </tr>

    </tbody>
  </table>
</div>

<div class="col-md-12">
  <table class="table keyboard-shortcuts">
    <thead>
      <tr>
        <th></th>
        <th>Search terms</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td><em>module:</em> (e.g. <a href="https://metacpan.org/search?q=module%3APlugin">module:Plugin</a>)</td>
      </tr>
      <tr>
        <td><em>distribution:</em> (e.g. <a href="https://metacpan.org/search?q=distribution%3ADancer+auth">distribution:Dancer auth</a>)</td>
      </tr>
      <tr>
        <td><em>author:</em> (e.g. <a href="https://metacpan.org/search?q=author%3ASONGMU+Redis">author:SONGMU Redis</a>)</td>
      </tr>
      <tr>
        <td><em>version:</em> (e.g. <a href="https://metacpan.org/search?q=version%3A1.00">version:1.00</a>)</td>
      </tr>
    </tbody>
  </table>
</div>
              </div>
              <div class="modal-footer"></div>
            </div>
          </div>
        </div>
    </body>
</html>
